====== serialCheck() ======

''int **serialCheck**(string //Seriennummer//)''

Die Funktion ''serialCheck()'' verrät, ob eine //Seriennummer// gültig ist und ob sie bereits verwendet wurde. Diese Funktion kann hilfreich sein, wenn man eine Seriennummer manuell abfragen möchte.

**Wichtig:** Mit der Funktion kann lediglich der Status einer Seriennummer geprüft werden -- die Seriennummer wird am Ende des Interviews nicht als "verbraucht" markiert.

===== Rückgabewert =====

Als Ergebnis liefert ''serialCheck()'' einen der folgenden Codes.

^Code^Bedeutung^
|-1|Es wurde keine Seriennummer angegeben|
|0|Die Seriennummer ist im Befragungsprojekt nicht bekannt|
|1|Die Seriennummer wurde bereits verbraucht (ein Fragebogen damit abgeschlossen)|
|2|Mit der Seriennummer wurde bereits ein Fragebogen aufgerufen, aber nicht abgeschlossen|
|3|Die Seriennummer wurde noch nicht verwendet|


===== Beispiel =====

Das folgende Beispiel geht davon aus, dass auf der vorhergehenden Seite im Texteingabefeld "AB01_01" eine Seriennummer erfragt wurde. Der PHP-Code prüft nun, ob die angegebene Seriennummer gültig ist. Falls nicht, zeigt der PHP-Code mittels ''[[:de:create:functions:repeatpage|repeatPage]]'' einen Textbaustein als Fehlermeldung sowie erneut die vorige Seite.

<code php>
$serial = value('AB01_01');
$status = serialCheck($serial);

if ($status == -1) {
  repeatPage('serialVoid');
} elseif ($status == 0) {
  repeatPage('serialWrong');
} elseif ($status == 1) {
  repeatPage('serialUsed');
}
</code>